home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / dev / misc / FlexCat.lha / FlexCat / FlexCat.readme < prev    next >
Encoding:
Text File  |  1997-08-07  |  6.2 KB  |  128 lines
  1. Short:    1.9 - Flexible catalogs (C, Asm, Oberon, E, ...)
  2. Author:   Marcin Orlowski <carlos@inet.com.pl>
  3. Uploader: Marcin Orlowski <carlos@inet.com.pl>
  4. Type:     dev/misc
  5. Version:  1.9
  6. Replace:  dev/misc/FlexCat*
  7. WWW:      http://wfmh.man.szczecin.pl/flexcat/
  8.  
  9.  
  10.   INFO
  11.   ----------
  12.  
  13.     FlexCat creates catalogs and the source to handle them.  The difference
  14.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  15.   designed to produce any source you want:  any programming language, any
  16.   individual needs should be satisfied.  However, FlexCat is not more
  17.   difficult to use.
  18.  
  19.     This sounds like a contradiction.  FlexCat's solution is to use
  20.   template files, the so called "source descriptions".  Ready to use examples
  21.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  22.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  23.   are welcome.
  24.  
  25.  
  26.   Changes since previous release:
  27.   -------------------------------
  28.  
  29.   * V1.9 (01.08.97) - Now you can use special $TODAY attribute
  30.                       in your $VER string. While creating catalog,
  31.                       $TODAY will be replaced by current date (note,
  32.                       only 1st occurance will be processed). If you
  33.                       want your version strings to always be recent
  34.                       dated type: $VER: FlexCat.catalog 3.0 ($TODAY)
  35.                       NOTE: This string is CASESENSITIVE!
  36.  
  37.                       FlexCat preferences added. To define your own
  38.                       defaults, set the environmental variable
  39.                       "flexcat.prefs" with the contents matching
  40.                       following template: "SDDIR/K,MSG_NEW/K,
  41.                       WARNCTGAPS/S,NOOPTIM/S,FILL/S,FLUSH/S,NOBEEP/S,
  42.                       QUIET/S". Note FlexCat is using ReadArgs()
  43.                       to parse the preferences, thus place all the
  44.                       items in one line.
  45.  
  46.                       If you use FlexCat for #?.ct updating, you
  47.                       probably was missing any additional markers
  48.                       to let you easily find the new strings. Now
  49.                       you get them. By default the "***NEW***", 
  50.                       is used, but you may configure it using
  51.                       FlexCat preferences.
  52.  
  53.                       QUIET switch used to suppress error messages.
  54.                       Fixed.
  55.  
  56.                       New C source descriptor Cat2h_?.sd. Read
  57.                       the manual or Lib/Cat2h.readme for more
  58.                       information.
  59.  
  60.                       Version of updated catalogs bumped to 2.5
  61.  
  62.                       Portugese translation of program catalog, thanks
  63.                       to Frederico Borges <famb@mail.telepac.pt> and
  64.                       Alexandre Gabriel <chryse@mail.telepac.pt>
  65.  
  66.                       Swedish translation of FlexCat manual,
  67.                       thanks to Magnus Holmgren <cmh@lls.se>
  68.  
  69.                       Spanish translation reworked by
  70.                       Marcos Broc <amiga187@arrakis.es> and 
  71.                       Samuel Aguilera <slyguy92@arrakis.es>
  72.  
  73.                       Now FlexCat does DisplayBeep() when any error
  74.                       or warning happen (but don't worry, it's smart
  75.                       enough, so you won't experience any Beep() bombing ;).
  76.                       By using NOBEEP switch you can shut it up.
  77.  
  78.                       Previous releases had problems with comment lines
  79.                       ending with \'s, which made FlexCat think it's multiline
  80.                       string. Now it is not as dumb to get fooled any longer.
  81.  
  82.                       You can now use octal, decimal and hexadecimal
  83.                       (e.g 0x20) digits for all FlexCat digital arguments
  84.                       (like ##version) as well as for (ID/MIN/MAX),
  85.                       ##codeset and others.
  86.  
  87.                       FLUSH switch added. By using it all unused
  88.                       catalogs (but also libraries, fonts, devices etc) will
  89.                       be flushed from memory, whenever new catalog is
  90.                       written. So note: FLUSH works only with CATALOG switch
  91.                       (it means while compiling new catalog).
  92.  
  93.                       New C source descriptors: catcomp_h.sd creates
  94.                       source (almost) identical to CatComp's ones, but
  95.                       expanded for multicatalog support. With this
  96.                       descriptor you can handle more than one catalog
  97.                       in your program harmless.  NOTE:  for compatibility
  98.                       reasons, other descriptors remain unchanged (however
  99.                       additional, multicatalog versions may appear
  100.                       in next release).
  101.  
  102.                       FlexCat does not accept empty ##language argument
  103.                       any longer.
  104.  
  105.                       FILL switch. This feature is highly useful for the
  106.                       translators, and probably for them only. Normally,
  107.                       when you're working on the new translation, some
  108.                       of the strings remains untranslated due the work
  109.                       is just in progress. Unfortunately all catalog
  110.                       tools write all these empty strings into the catalog
  111.                       file, which will cause empty buttons, menus or simmilar
  112.                       things to appear whenever you check your unfinished
  113.                       translation with the program, which isn't nice effect.
  114.                       Using FILL you may force FlexCat to ignore all empty
  115.                       translations (strings from #?.ct file) and instead
  116.                       to write original string (from #?.cd) to the catalog.
  117.                       That prevents you from watching empty GUI etc.
  118.                       NOTE: this option is only for testing purposes.
  119.                       Final catalogs should always be created without FILL
  120.                       switch used!
  121.  
  122.                       English manual is now up-to-date.
  123.  
  124.                       Added %a, %t and %z operands for source
  125.                       descriptors. See (probably english and
  126.                       swedish only, for now) manual for detailed
  127.                       information
  128.